home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / HENSA / COMMS / NLISTMGR.ARC / !NListMgr / !Help < prev    next >
Text File  |  1994-08-06  |  9KB  |  209 lines
  1. !NListMgr 1.10 (C) Steven Haslam 1994
  2. —————————————————————————————————————
  3.  
  4. Overview
  5. ————————
  6.  
  7. NListMgr will compile FidoNet nodelists from the distributed ("FTS-0005")
  8. format into a special format, and provides a module with SWIs to perform
  9. operations on this special format.
  10.  
  11. Changes from previous versions
  12. ——————————————————————————————
  13.  
  14. From 1.00: 
  15.  
  16. • QuickBBS and old ArchyList support removed. File "NodesIndex"
  17. changed, renamed to "SystIndex". Files "SystCache" and "ZoneIndex" added.
  18. Location field added to "NodesInfo".
  19.  
  20. • Removed buttons and configuration flag for address format: set
  21. FTNlib$AddrFormat to "@" or "#" to change
  22.  
  23. • Removed NodeServer module
  24.  
  25. • Implemented index section-cacheing facility: the memory-held cache may be
  26. limited to a selection of nodes; this is currently limited to four general
  27. classes (all, edited, protected or none)
  28.  
  29. • Module uses a different format for addresses internally; new SWIs added to
  30. use these, old numbers have compatibility veneers.
  31.  
  32. • Module now takes name of nodelist directory as a parameter, and ASSUMES
  33. that the domains file is called "Domains" (so if it's called anything else,
  34. you'll have to change it).
  35.  
  36. • Module properly supports extended domains file, with technology character
  37. etc.
  38.  
  39. • Application reads domains table from module not directly, so should always
  40. read the same thing (!)
  41.  
  42. • Data cache size can now be varied by setting NListMgr$DataCacheSize
  43.  
  44. • Module doesn't currently support scanning the nodelist below zone level :-#
  45.  
  46. • Module SWIs to read/write address strings removed; write your own, or ask
  47. me for some library functions
  48.  
  49. • Configuration files kept as text files, not binary (conversion program
  50. supplied)
  51.  
  52. • Editing manager reads data from nodelist for field defaults
  53.  
  54. From 1.10.dev:
  55.  
  56. • Implemented variable-size file cache
  57.  
  58. • Module allows just one domain to be read from table
  59.  
  60. • Implemented MegaOps to save disk thrashing
  61.  
  62. • Finished off scanning, extended the types of scanning now possible.
  63.  
  64. Installation
  65. ————————————
  66.  
  67. If you have a copy of NListMgr 1.00, you may use your old configuration
  68. files, although it is essential to convert them, since their format has
  69. changed. A program is provided for this purpose.
  70.  
  71. You may want to keep a backup of your old !NListMgr application, in case
  72. anything goes wrong.
  73.  
  74. It is advisable to run your old !NListMgr and quit it before installing the
  75. new one, as this will check that system variable etc. point to the right
  76. application, and that the position of your nodelist directories are recorded
  77. for the conversion program.
  78.  
  79. Drag the new !NListMgr icon on top of the old one; RISC-OS will sort out for
  80. you which files have changed since your version, and will copy those.
  81.  
  82. Double-click on the program file "convertcfg". The Filer must have seen
  83. !Scrap for this program to work, and it must be on the same disk as
  84. !NListMgr. The disk will chunter along for a while, and finally the nodelist
  85. setup window should appear. This is to re-write the module loader files: your
  86. nodelist directory should already be written inside the "save box" and you
  87. should be able to just click on OK. If it isn't, or if you want to
  88. install a new nodelist directory, drag the directory to your nodelist
  89. directory, or click on one of the two buttons to the right to indicate the
  90. proper position of the nodelist.
  91.  
  92. You should now be able to run the new !NListMgr.
  93.  
  94. If you do not have an existing copy of !NListMgr, then you will not need the
  95. "convertcfg" program. Just copy the !NListMgr program to wherever you want to
  96. keep it, and double-click on its icon in the Filer window. Because you're
  97. running it for the first time, a window will open asking you to choose where
  98. you want your nodelist to be kept. This means your COMPILED nodelists: so it
  99. should be a hard disk, if possible, but not a RAM disk.
  100.  
  101. To set the position, drag the directory to a Filer window, enter the pathname
  102. in the writeable icon and click on OK or click on one of the two buttons to
  103. the right of the window to choose a pre-defined place (inside the !Net_Areas
  104. or the !NListMgr application).
  105.  
  106. The directory you have chose will be created, with a text file inside called
  107. "Domains". Then the main program will load and install itself on the icon
  108. bar. It will also open up the miscellaneous configuration window for you to
  109. set various options, if you wish.
  110.  
  111. Using NListMgr to configure your system
  112. ———————————————————————————————————————
  113.  
  114. It is expected that you are familiar with the concept of domains, and what a
  115. domain represents and signifies.
  116.  
  117. Each domain has a separate compiled nodelist; they'll usually have a separate
  118. FTS-0005 nodelist, too.
  119.  
  120. To configure your domains, click SELECT on the NListMgr icon on the icon bar.
  121. This window is called the "domains manager". For information on specific
  122. icons, load the Interactive Help application. However, to set up the domain,
  123. you need to drag on the directory where the FTS-0005 nodelists are kept,
  124. enter their leafnames in the table, and choose how much of the nodelist you
  125. want to have cached at once.
  126.  
  127. If the nodelist is issued weekly, with a different number each week, enter
  128. the leafname with three hash ('#') characters where the number should go.
  129.  
  130. Remember to click on the "Write" button once you have made your changes!
  131.  
  132. Call costing and dial translation
  133. —————————————————————————————————
  134.  
  135. These features do *NOT* have WIMP interfaces; you use a text editor to edit
  136. configuration files. Sorry about this, but any WIMP interface for these that
  137. I would write would be utterly disgusting....
  138.  
  139. To edit the files, double-click on the !NListMgr icon with SHIFT (either
  140. SHIFT) held down. A directory display will open containing a directory called
  141. "Resources". Open this directory, and load the text files "DialTrans" and
  142. "CallCost". These files contain their own documentation.
  143.  
  144. You should only have to edit these files once, unless you move house and your
  145. phone exchange changes :-} In the UK, you will have to change the file by
  146. phONEday, because it contains exchange codes.
  147.  
  148. When you have edited the files, save them. The quit !NListMgr and re-run it:
  149. this is necessary beacuse !NListMgr only reads the files when it is loaded.
  150.  
  151. Compiling nodelists
  152. ———————————————————
  153.  
  154. To compile the nodelist for a domain, move the the relevant domain in
  155. the domains manager, click MENU over the window and choose "Compile". The
  156. compilation will take place in the background. When this is completed, the
  157. nodelist is available to client tasks; but clients are not allowed to access
  158. the nodelist while the nodelist is being compiled: check that mailers are not
  159. going to dial out while you are recompiling the nodelist, and so on.
  160.  
  161. Altering the data in the nodelist
  162. —————————————————————————————————
  163.  
  164. NListMgr allows you to edit the data between reading it from the FTS-0005
  165. nodelist and writing it to the compiled nodelist. This includes the insertion
  166. of systems, renaming systems, changing phone numbers, availability flags or
  167. capability flags.
  168.  
  169. This is all done through the "editing manager". To access the editing
  170. manager, click on the NListMgr icon with ADJUST.
  171.  
  172. Again, use Interactive Help for help on specific icons.
  173.  
  174. If you have compiled the nodelists already, then you can have NListMgr fill
  175. in the fields with data from the nodelist. If you enter just the address and
  176. click on the "Write" icon, then NListMgr will check the address, and try to
  177. find it in the nodelist. If it can, it will put the nodelist data in the
  178. fields that you have not flagged to be changed.
  179.  
  180. Final comments
  181. ——————————————
  182.  
  183. I think that's just about it. Sorry about the docs being crap (again).
  184.  
  185. The application is not beautiful: the data managers want speeding up, the
  186. compiler/WIMP interface needs tidying, the compiler needs speeding up (a
  187. "Faster" option would be nice). There ought to be a better way of specifying
  188. which systems to cache, and so on. However, the important thing was to get
  189. cacheing working at all, and to get the new module and new structures
  190. working. The application serves its purpose near enough.
  191.  
  192. If you want QuickBBS nodelists, write your own convert-program, and use the
  193. NodeServer module... it's too much hassle to keep them in now, and they don't
  194. support the cacheing anyway.
  195.  
  196. To contact me, it's probably best to call me voice... my FidoNet address is
  197. pretty much dead. I can usually be found on the ARCNET, ARCBINKLEY, ARCCOMMS
  198. etc. echoes. I'm going to university in October, too, so after then I won't
  199. be as easy to find. Try talking to Keith Hall on 2:250/219 if you have
  200. problems.
  201.  
  202. I would be interested to hear if this program runs on RiscOS 3.00 or RiscOS
  203. 2. But I doubt if it will: unfortunately, I can't test it. Last I heard, it
  204. didn't.
  205.  
  206. I am:
  207.     Steven Haslam, 112 Keighley Road, Colne, Lancashire, ENGLAND BB8 0PH
  208.     VOICEphone: +44-282-866835
  209.